home *** CD-ROM | disk | FTP | other *** search
/ Network Support Library / RoseWare - Network Support Library.iso / sna / wsdup.exe / SIDEHELP.HLP (.txt) < prev    next >
Help Librarian Help File  |  1992-01-08  |  25KB  |  429 lines
  1. C-Worthy (R) Help Librarian Data File Version 1.0
  2. COPYRIGHT (C) 1985 - 1989.  All Rights Reserved.
  3. Custom Design Systems, Inc.  Orem, Utah  USA.
  4.                     LOCAL LU CONFIGURATION DATA
  5.      LU Name:  The name (8 or fewer chacters) you create to 
  6.                identify local LU to NetWare LU6.2. 
  7.                Use only uppercase letters, numbers or the characters
  8.                $, #, and @. The first character must not be numeric.
  9.      PU Name:  The name (8 or fewer chacters) you create to 
  10.                define the PU's network name. 
  11.                Use only uppercase letters, numbers or the characters
  12.                $, #, and @. The first character must not be numeric.
  13.                                              Page 1 of 6
  14.                     LOCAL LU CONFIGURATION DATA
  15.      Network Name:  The name (8 or fewer chacters) you create to 
  16.                     define the network name that contains the PU.
  17.                     It is used during XID negotiation with other
  18.                     type 2.1 nodes. 
  19.                     Use only uppercase letters, numbers or the
  20.                     characters $, #, and @. The first character must
  21.                     not be numeric.
  22.      Security Type: Grants or denies access to various levels of
  23.                     security the remote LU may need in order to
  24.                     verify the request for accessing the remote LU's
  25.                     programs.
  26.                                              Page 2 of 6
  27.                     LOCAL LU CONFIGURATION DATA
  28.                     Values are:
  29.                     0 -  Specifies no conversation-level security enabled.
  30.                     1 -  Instructs the remote LU to supply the pre-approved
  31.                          user ID with the security request.
  32.                     2 -  Instructs the remote LU to use whatever security
  33.                          information is in the domain of the program.  If
  34.                          you use this value, you must also define the User
  35.                          ID and PassWord fields on this screen.
  36.      User ID:  The name (8 or fewer characters) you create to define the
  37.                user ID.  A user ID is required if a value of 2 is specified
  38.                for Security Type.
  39.                                                          Page 3 of 6>
  40.                     LOCAL LU CONFIGURATION DATA
  41.      Password: A string (8 or fewer characters) you create to
  42.                define the end user's password.  A password is
  43.                required if you specified a value of 2 for Security
  44.                Type.
  45.      LU Local Address:
  46.                The logical session number for the local LU. It must
  47.                be in the range from 0 to the number of host sessions
  48.                assigned to your workstation or server.
  49.                     
  50.                                              Page 4 of 6;
  51.                     LOCAL LU CONFIGURATION DATA
  52.                If the LU you are defining may engage in the host
  53.                LU-LU sessions, use a non-zero value that corresponds
  54.                to one of the host sessions you have customized to be
  55.                a LU6.2 session for your workstation or server.
  56.                
  57.                If the LU you are defining will engage only in
  58.                peer-to-peer sessions, set the address to 0.
  59.      LU SESSION LIMIT: 
  60.                Specifies the maximum number of concurrently active
  61.                sessions you want to allow between the local LU and
  62.                its remote LU.
  63.                Use decimal numbers only.
  64.                                              Page 5 of 6
  65.                     LOCAL LU CONFIGURATION DATA
  66.      DETACH PU TYPE: 
  67.                Specifies the manner in which LUs attached by your 
  68.                workstation or server detach from NetWare LU6.2.
  69.                Values are:
  70.                0 -  Immediately detaches all LUs attached by a 
  71.                     workstation or server if that unit requests
  72.                     immediate detachment.
  73.                1 -  Detaches all LUs attached by a workstation or 
  74.                     server if that unit requests detachment only in 
  75.                     the absence of outstanding conversations.
  76.                                              Page 6 of 6
  77.                       SIDE INFORMATION RECORD
  78.      Specify the name of the side information record that you want to create,
  79.      view, modify, or delete.
  80.      *  To name a new side information record, type a name (8 characters or
  81.         less) and press <Enter>.  Use alphanumeric characters only.
  82.      *  To list existing side information records in this file, press <Ins>.  
  83.      *  To select one of the listed records for viewing, modifying, or
  84.         deleting, use the arrow keys to select the record name and press
  85.         <Enter>.  Then press <Enter> again.
  86.      A description of side information record data follows.
  87.                                                             Page 1 of 2
  88.                       SIDE INFORMATION RECORD
  89.      Each side information record consists of configuration data about the
  90.      local LU, the remote LU, and the mode used between those two LUs.
  91.      The Local LU Data screen includes the following data: LU name,
  92.      PU Name, Network Name, Security Type, User ID, Password, LU Local 
  93.      address, LU session limit, and Detach PU type.
  94.      The Remote LU Data screen includes the following data: 
  95.      LU Name, Data Link Control Number, Network Adapter Number, Network
  96.      Adapter Address, LU Session Limit, Max Logical Record Size, Character
  97.      Set, Local Program Name, and Remote Program Name.
  98.      The Mode Configuration Data screen includes the following data: 
  99.      Mode Name, Max Negotiable Session Limit, Automatic Activate Session
  100.      Limit, Min Contention Winners Source, Min Contention Winners Target,
  101.      Pacing Size, Min RU Size, CNOS Flags, and CNOS Termination Set.
  102.                                                             Page 2 of 25
  103.                        REMOTE LU CONFIGURATION DATA
  104.      LU Name:  The name (8 or fewer characters) that identifies the partner                LU to NetWare LU6.2.
  105.                Use only uppercase letters, numbers, or the character $, #, 
  106.                and @.  The first character must not be numeric.
  107.      Data Link Control Name: 
  108.                Gives the Data Link Control identification needed for 
  109.                communicating with the remote LU. Values are: ITRN, SDLC, or
  110.                COAX.  Descriptions follow. 
  111.                                                             Page 1 of 8
  112.                        REMOTE LU CONFIGURATION DATA
  113.           ITRN      Use this value for the following remote locations:
  114.                     
  115.                     (1) The remote LU is located in a workstation that is 
  116.                         supported by the same server as your workstation.
  117.                         Both Network Adapter Number and Network Adapter 
  118.                         Address must be set to 0.
  119.                     (2) The remote LU is located in a host accessed via a 
  120.                         token ring network adapter to an IBM 3174 control
  121.                         unit or an IBM 3725/3745 communications controller. 
  122.                         The Network Adapter Address must be set to the 3714
  123.                         or 37x5 node address.
  124.                     (3) The remote LU is located in another server that is 
  125.                         connected to the same token ring network as your 
  126.                         server. The Network Adapter Address must be set to
  127.                         the token ring node address of the remote LU's
  128.                         server. 
  129.                                                            Page 2 of 8
  130.                        REMOTE LU CONFIGURATION DATA
  131.                (4)  The remote and local LU's are running on the same server. 
  132.           SDLC - Use this value to establish a workstation-to-host or
  133.                  server-to-host connection via either a coaxial or a
  134.                  Synchronous Data Link Control adapter.
  135.           COAX - Use this value to establish a workstation-to-host or
  136.                  server-to-hos connection via a coaxial connection to a
  137.                  3174/3274 control unit. NetWare LU6.2 defaults to COAX if
  138.                  you specify SDLC and no SDLC adapter is present.
  139.      Network Adapter Number: 
  140.           Determines whether the token ring network adapter (in your server),
  141.           by which the remote LU is accessed is primary (0) or alternate (1).
  142.           If you specify a peer-to-peer connection, set this field to 0.
  143.                                                                  Page 3 of 8
  144.                      REMOTE LU CONFIGURATION DATA
  145.      Network Adapter Address:  Specifies the remote LU's adapter address.
  146.                
  147.           If the remote LU is located in a workstation supported by a
  148.           server, set this parameter to the 6-byte locally administered
  149.           token ring address of the remote LU's server.
  150.                
  151.           If both workstations are supported by the same server,
  152.           set this parameter to binary zero (000000000000).
  153.           If the remote LU is located in a host accessed via a coaxial cable
  154.           or SDLC gateway server, set this parameter to binary zero
  155.           (000000000000).
  156.           If the remote and local LU's are located on the same server, set
  157.           this parameter to binary zero (000000000000).
  158.                                                        Page 4 of 8
  159.                        REMOTE LU CONFIGURATION DATA
  160.           If the remote LU is located in a host accessed by the NetWare 
  161.           token ring gateway server, set this parameter to the 6-byte
  162.           locally-administered address of the connected 3174/37x5 (for
  163.           example: 40010020abef).
  164.      LU Session Limit:
  165.           The maximum number of concurrently active sessions you will 
  166.           allow between the local LU and remote LU.
  167.      Max Logical Record Size:
  168.           Specifies the maximum logical record size a mapped conversation
  169.           can use when building a logical record.  Specify a decimal value
  170.           between 0 and 32767.  The default value, 0, is converted to the  
  171.           maximum record size, 32767. Values of 1, 2, or 3 are converted to
  172.           4.       
  173.                                                             Page 5 of 8*-
  174.                     REMOTE LU CONFIGURATION DATA
  175.      Character Set: 
  176.           Specifies one of three character sets for character conversion
  177.           from EBCIDIC to ASCII or from ASCII to EBCIDIC. Values are 0,
  178.           1, or 2.
  179.           0    specifies the following set: lower-cased a-z; numerics 0-9;
  180.                and special characters $,#,@, and (.).  No restrictions of 
  181.                position of characters.  Trailing blanks are allowed.
  182.           1    specifies the following set: lower-cased a-z; uppercase A-Z;
  183.                numerics 0-9, and special characters $, #, and @.
  184.                When converting ASCII to EBCIDIC lowercase is converted to 
  185.                uppercase; when converting in either direction, the first
  186.                character can not be numeric, trailing blanks are allowed. 
  187.                                                             Page 6 of 8
  188.                     REMOTE LU CONFIGURATION DATA
  189.           2    specifies the following set: any kind of character allowed,
  190.                but under the following conditions:
  191.                  
  192.                *    You have provided a proper conversion code table to 
  193.                     NetWare LU6.2.
  194.                *    You have customized NetWare LU6.2 for that table.
  195.      Local Program Name: 
  196.           Specifies the name of the NetWare LU6.2 program associated with the
  197.           local LU.  The maximum length is 64 characters.
  198.           
  199.                                                                  Page 7 of 8 
  200.                     REMOTE LU CONFIGURATION DATA
  201.      Remote Program Name: 
  202.           Specifies the name of the NetWare LU6.2 program associated with 
  203.           the remote LU.  The maximum length is 64 characters.
  204.                                                             Page 8 of 8
  205.                     MODE FILE CONFIGURATION DATA
  206.     Mode Name: The name (8 or fewer characters) you create to 
  207.                identify the partner LU to NetWare LU6.2.
  208.                Use only uppercase letters, numbers, or the characters
  209.                $, #, and @. The first character must not be numeric.
  210.     Max Negotiable Session Limit: 
  211.                Specifies the number of sessions you want to permit
  212.                a CNOS verb to specify for the local LU and the 
  213.                remote LU using this mode.  The actual maximum may 
  214.                be a smaller value, depending on the results of 
  215.                CNOS negotiation.
  216.                Specify using decimal values.
  217.                                                   Page 1 of 13
  218.                     MODE FILE CONFIGURATION DATA
  219.      Automatic Activate Session Limit: 
  220.                Specifies the number of contention-winner sessions
  221.                from the local LU that NetWare LU6.2 automatically
  222.                activates during the CPI-C application subsystem 
  223.                process.
  224.                Specify a decimal number.
  225.                                                   Page 2 of 13
  226.                     MODE FILE CONFIGURATION DATA
  227.      Min Contention Winners Source: 
  228.                     Specifies the minimum number of sessions that
  229.                     will guarantee the source (i.e. local) LU to be
  230.                     the session contention winner.
  231.                     Specify a decimal number greater than or equal
  232.                     to 0.
  233.      Min Contention Winners Target: 
  234.                     Specifies the minimum number of sessions that
  235.                     will guarantee the target(i.e. remote) LU to be
  236.                     the session contention winner.
  237.                     Specify a decimal number greater than or equal
  238.                     to 0. 
  239.                                                      Page 3 of 13g;
  240.                     MODE FILE CONFIGURATION DATA
  241.  Pacing Size:  Specifies the maximum number of SNA messages that the
  242.                local LU can receive without sending a pacing
  243.                response.  Serves as a form of buffer control.
  244.                Values are integers 0 through 63. 0 directs NetWare
  245.                LU6.2 not to use any pacing.
  246.  Max RU Size:  Defines the maximum Request Unit (RU) sizes that may
  247.                be used by sessions that have this mode. 
  248.                Specify integers from 16 to 4096.  For efficiency, 
  249.                a minimum setting of 256 is recommended.
  250.                                                   Page 4 of 13
  251.                     MODE FILE CONFIGURATION DATA
  252.  Min RU Size:  Defines the minimum Request Unit (RU) sizes that may
  253.                be used by sessions that have this mode.
  254.                Specify integers from 16 to 4096.  For efficiency, a 
  255.                minimum setting of 256 is recommended.
  256.  CNOS Flags:   Specifies a combination of four field settings for the
  257.                APPC CNOS Flag parameter:
  258.                     Mode_Name_Select_One or Mode_Name_Select_All,
  259.                     Set_Negotiable_Yes or Set_Negotiable_No,
  260.                     Initiated_Yes or Initiated_No, and
  261.                     Sync_Level_None or Sync_Level_Confirm.
  262.                Functions of the above settings follow:
  263.                                                   Page 5 of 13
  264.                     MODE FILE CONFIGURATION DATA
  265.        Mode_Name_Select_One - Specifies that only the mode name 
  266.                               defined in the NetWare LU6.2 CNOS
  267.                               function call will be affected by
  268.                               changes to session limits and
  269.                               polarities.
  270.        Mode_Name_Select_All - Specifies that all session limits and
  271.                               polarities for all mode names that
  272.                               belong to the target(i.e. remote)
  273.                               LU shall be changed.
  274.        Set_Negotiable_No -    Does not allow NetWare LU6.2 to
  275.                               override session limits.
  276.        Set_Negotiable_Yes -   Allows NetWare LU6.2 to override
  277.                               session limits. 
  278.                                                   Page 6 of 137E
  279.                     MODE FILE CONFIGURATION DATA
  280.        Initiated_Yes -   Indicates that the CPIC application 
  281.                          subsystem initiates a CNOS call for this
  282.                          mode file.
  283.        Initiated_No -    Indicates that the CPI-C application
  284.                          subsystem does not initiate a CNOS call for
  285.                          this mode file.
  286.        Sync_Level_None - Specifies no synchronization level between
  287.                          the local transaction program and the remote
  288.                          transaction program.
  289.     Sync_Level_Confirm - Specifies the confirm synchronization level
  290.                          between the local and remote transaction.
  291.         
  292.                                                   Page 7 of 13
  293.                     MODE FILE CONFIGURATION DATA
  294.  Acceptable values for CNOS FLAGS and the settings they specify are listed
  295.  below:
  296.  0 - Mode_Name_Select_One; Set_negotiable_No; Initiated_No; Sync_Level_None
  297.  1 - Mode_Name_Select_All; Set_negotiable_No; Initiated_No; Sync_Level_None
  298.  2 - Mode_Name_Select_One; Set_Negotiable_Yes; Initiated_No;Sync_Level_None
  299.  3 - Mode_Name_Select_All; Set_Negotiable_Yes; Initiated_No;Sync_Level_None
  300.  4 - Mode_Name_Select_One; Set_Negotiable_No; Initiated_Yes;Sync_Level_None
  301.  5 - Mode_Name_Select_All; Set_Negotiable_No; Initiated_Yes;Sync_Level_None
  302.  6 - Mode_Name_Select_One; Set_Negotiable_Yes; Initiated_Yes; 
  303.      Sync_Level_None
  304.  7 - Mode_Name_Select_All; Set_Negotiable_Yes; Initiated_Yes;
  305.      Sync_Level_None
  306.  8 - Mode_Name_Select_One; Set_Negotiable_No; Initiated_No;
  307.      Sync_Level_Confirm
  308.                                                        Page 8 of 13
  309.                     MODE FILE CONFIGURATION DATA
  310.   9 - Mode_Name_Select_All; Set_Negotiable_No; Initiated_No;
  311.       Sync_Level_Confirm
  312.  10 - Mode_Name_Select_One; Set_Negotiable_Yes; Initiated_No;
  313.       Sync_Level_Confirm
  314.  11 - Mode_Name_Select_All; Set_Negotiable_Yes; Initiated_No;
  315.       Sync_Level_Confirm
  316.  12 - Mode_Name_Select_One; Set_Negotiable_No; Initiated_Yes;
  317.       Sync_Level_Confirm
  318.  13 - Mode_Name_Select_All; Set_Negotiable_No; Initiated_Yes;
  319.       Sync_Level_Confirm
  320.  14 - Mode_Name_Select_One; Set_Negotiable_Yes; Initiated_Yes
  321.       Sync_Level_Confirm
  322.  15 - Mode_Name_Select_All; Set_Negotiable_Yes; Initiated_Yes
  323.       Sync_Level_Confirm
  324.                                              Page 9 of 13:O
  325.                     MODE FILE CONFIGURATION DATA
  326.      CNOS Termination Set: 
  327.      Specifies a combination of three field settings for the CNOS Flag
  328.      parameter: Responsible_Source or Responsible_Target;
  329.                 Drain_Source_Yes or Drain_Source_No
  330.                 Drain_Target_Yes or Drain_Target_No
  331.      Functions of the possible settings follow:
  332.      Responsible_Source  Specifies that the source LU is solely responsible 
  333.                          for deactivating sessions.
  334.           
  335.      Responsible_Target  Specifies that the target LU is initially  
  336.                          responsible for deactivating sessions.  The target 
  337.                          LU can negotiate this responsibility with the source
  338.                          LU and make the source LU responsible.
  339.                                                                Page 10 of 13
  340.                     MODE FILE CONFIGURATION DATA
  341.      Drain_Source_No -   Does not allow the source LU to void its
  342.                          allocation requests.
  343.      Drain_Source_Yes -  Allows the source LU to void its allocation 
  344.                          requests.
  345.                              
  346.      Drain_Target_No -   Does not allow the target LU to void its
  347.                          allocation requests.
  348.      Drain_Target_Yes -  Allows the target LU to void its allocation
  349.                          requests.
  350.                                                   Page 11 of 13nT
  351.                     MODE FILE CONFIGURATION DATA
  352.      Acceptable values for CNOS Termination and the settings they 
  353.      specify are:
  354.      0 - Responsible_Source; Drain_Source_No; Drain_Target_No
  355.      1 - Responsible_Source; Drain_Source_No; Drain_Target_Yes
  356.      2 - Responsible_Source; Drain_Source_Yes; Drain_Target_No
  357.      3 - Responsible_Source; Drain_Source_Yes; Drain_Target_Yes
  358.      4 - Responsible_Target; Drain_Source_No; Drain_Target_No
  359.      5 - Responsible_Target; Drain_Source_No; Drain_Target_Yes
  360.      6 - Responsible_Target; Drain_Source_Yes; Drain_Target_No
  361.      7 - Responsible_Target; Drain_Source_Yes; Drain_Target_Yes
  362.                                                   Page 12 of 13
  363.                  MODE FILE CONFIGURATION DATA
  364.      SAA Service Profile Name: 
  365.           Specifies an SAA Service Profile to be used for this session.
  366.           The name can be from 1 to 8 characters long.
  367.           This field applies only to side information files used by the
  368.           CPIC NLM in the Netware Communication Services environment.
  369.           It is not required for side information files used by CPI-C 
  370.           programs at the DOS-based NetWare 3270 Workstation.
  371.           An SAA service profile is a collection of information about the
  372.           server's connection to the SNA host as well as the sessions to
  373.           be obtained through that connection. For example, the service
  374.           profile specifies the number of LUs available on the host, the
  375.           types of LUs available, and the users authorized to use the LUs.
  376.                                                             Page 13 of 13 
  377.        Exit Side Information File Command
  378.  If you are finished using the Side Information
  379.  File utility, answer YES; otherwise, answer NO
  380.  or press <Esc>.
  381.  No changes will be lost by exiting at this
  382.  point.
  383.                                    Page 1 of 1
  384.         Create A Side Information File
  385.  Type the name of the side information file
  386.  that you want to create and press <Enter>.
  387.  If the file is in not in the current
  388.  directory, you must include the path of the
  389.  file name. For example, "c:\cpi\Example.cpi".
  390.  The filename extension must be "cpi".
  391.                                Page 1 of 1
  392.          Create A Side Information File
  393.          Editing A Side Information File
  394.  Type the name of the side information file
  395.  you want to edit and press <Enter>.
  396.  If the file is not in the current directory,
  397.  include the path of the filename.
  398.  To list all side information files in the 
  399.  current directory, press <Ins>.
  400.                               Page 1 of 1
  401.           Add A Side Information Record
  402.  This command creates a new side information
  403.  record that will be saved in the side
  404.  information file.
  405.  The side information record name must be
  406.  unique among all other side information
  407.  records contained in the current side
  408.  information file. 
  409.                          Page 1 of 1
  410.        Delete A Side Information Record
  411.  Type the name of the side information record
  412.  that you want to delete from the side infor-
  413.  mation file and then press <Enter>.
  414.  To list all the side information records in
  415.  the side information file, press <Ins>.
  416.                               Page 1 of 1
  417.         Modify A SIde Information Record
  418.  Type the name of the side information record
  419.  you want to modify and press <Enter>.
  420.  To list all side information records in the
  421.  side information file, press <Ins>.
  422.                               Page 1 of 1
  423.        Display A Side Information Record
  424.  Enter the name of the side information record
  425.  you want to display and press <Enter>.
  426.  To list all the side information records in
  427.  the side information file, press <Ins>.
  428.                               Page 1 of 1
  429.